home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 8 / Mac Magazin and MacEasy Magazine CD - Issue 08.iso / Sharewarebibliothek / Updater⁄Infos / Frontier 2.0 => 2.0.1 Upgrader / Install Files / DocServer Docs / dialog.runModeless < prev    next >
Text File  |  1993-02-25  |  2KB  |  19 lines
  1.  
  2. Verb    dialog.runModeless
  3. Syntax    dialog.runModeless (resnum, defaultitem, itemhitcallback)
  4. Parameters    resnum  is the resource number of a DLOG resource
  5. defaultitem  is the item that's bold in the dialog and acts as the default response if the user hits the Return or Enter key.
  6. itemhitcallback  is the address of a script to be executed when an item in the dialog is hit and the user's action must be processed.
  7. Action    Runs a modeless dialog
  8. Returns    True
  9. Examples    See the Frontier script search.dialog for an example of the use of this verb.
  10. Notes    • This is an advanced Frontier verb of primary interest to implementers and advanced scripters. It is not necessary to understand it to use Frontier effectively for most tasks.
  11. • This verb opens a new window to run the dialog. The window stays around while you’re running Frontier and the callback routine gains control when you click on a button.
  12. • The callback script must accept a single parameter that is the number of the item hit. It should return false to dismiss the dialog, true continue accepting user input.
  13. • Before the dialog is displayed and user input is accepted, the callback script is called with the special item value -1, to allow it to initialize the dialog’s items as appropriate.
  14. • If the user clicks in the dialog window’s close box, the callback script is called with the special item value -2, to allow it to perform any final actions. In this one case, the value returned by the callback is ignored.
  15. • The callback script can call clock.sleepFor to request that it be called again in a specified period, if no user input is received. The script will be called with the special item value -3 to indicate that the user didn’t select an item.
  16. • If a dialog with the same resnum is already running from another script, executing this verb brings that dialog to the front and returns true, but itemhitcallback is not called.
  17. See Also    clock.sleepFor
  18. dialog.run
  19.